home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-11 / sezyou.zip / README.1ST < prev    next >
Text File  |  1993-01-04  |  11KB  |  251 lines
  1.  
  2.                          SEZ_YOU!
  3.  
  4. Tired of Those nagging support calls about "open error (4)"? Sick of
  5. batch file madness to get multiple clipper-compiled applications to 
  6. coexist on the same machine? Do you know where your "SET CLIPPER=" 
  7. string is? Bothered by illegal copies of your applications that you 
  8. can't track? Is that what's troubling you, Bunkie?
  9.  
  10. SEZ_YOU! lets YOU show your clipper-compiled application who's the 
  11. boss...  Says who? SAYS YOU!
  12.  
  13. SEZ_YOU! is a developer's utility for Clipper Summer '87, that permits 
  14. displaying and/or resetting of the internal "default" values for the 
  15. environmental variables in a Clipper-compiled .exe file. SEZ_YOU! can 
  16. also display or alter the name of the environmental string to which 
  17. the application will respond.  Additionally, SEZ_YOU! can "brand" a 
  18. scrambled copy of your custom identification string deep within the 
  19. .exe file. A set of user-defined-functions are provided that return 
  20. the contents of the environmental variables, the environmental string 
  21. name, and the unscrambled identification string.
  22.  
  23. SEZ_YOU! is command-line driven, using a syntax very similar to the 
  24. normal SET CLIPPER= string. It may be run from a batch file, the DOS 
  25. prompt, or a MAKE utility for convenience.
  26.  
  27.  
  28.  
  29.               ABOUT THE SEZ_YOU DEMO...
  30.  
  31. The demonstration-size version distributed in this package as been 
  32. partially defunctionalized. However, enough functionality has been 
  33. preserved to permit you to play with SEZ_YOU! on the enclosed demo 
  34. program, or on a clipper-compiled program of your own - there is no 
  35. file size limitation. Although the full version will permit alteration 
  36. of all of the environmental values, the trial size package will only 
  37. alter the R and X parameters. This will allow you to demonstrate the 
  38. program's effectiveness, since you can see the results by setting the 
  39. values to intentionally generate inadequate memory errors. Remember 
  40. to issue a "SET CLIPPER=" command first, to clear the environment of 
  41. any previous strings, as these will over-ride the internal values.
  42.  
  43. The trial size version will allow you to brand the target .exe file 
  44. with an encrypted identification code, but will use the string 
  45. "DEMO_01" regardless of the value you pass on the command line, 
  46. following the "I" parameter.
  47.  
  48. The clipper-compiled demo program also demonstrates the use of the
  49. companion functions to return information about the environmental 
  50. values and string name, together with the identity code.
  51.  
  52.                                -2-
  53.  
  54.  
  55.                      PROVING THAT IT WORKS...
  56.  
  57. Unfortunately, it is not easy to demonstrate the power, versatility, 
  58. and ease of use of SEZ_YOU!. But if you will take the time to try the 
  59. experiments suggested here, you'll see just why SEZ_YOU! is an 
  60. exciting, useful, and totally unique product. Just remember that it's 
  61. much easier to USE than it is to DESCRIBE! (If you understand the 
  62. syntax of the SET CLIPPER= string, you already know most of the rules 
  63. for using SEZ_YOU!)
  64.  
  65. 1. Begin by linking the demonstration files with the clipper 
  66.       libraries to build the demo program:
  67.  
  68.                 TLINK SDEMO GETDEMO,,,CLIPPER EXTEND
  69.                 PLINK86 FI SDEMO, GETDEMO LIB CLIPPER, EXTEND
  70.  
  71. 2. Display the command line syntax for SEZ_YOU! by entering the DOS 
  72.       command:  
  73.                 SYDEMO
  74.  
  75. 3. Now use SEZ_YOU! to examine the status of the freshly-linked .exe 
  76.       file:
  77.                 SYDEMO SDEMO.EXE
  78.  
  79.       The screen display will show that all of the values are at their 
  80.       default settings, that there is no identification code in use, 
  81.       and that the program will respond to an environmental string 
  82.       named "CLIPPER". Since no additional parameters were passed, no 
  83.       alterations were made to the target file.
  84.  
  85. 4. Try the identification-code branding. The trial-size SEZ_YOU! will 
  86.       always use the code "DEMO_01" regardless of the value you pass,
  87.       although the full version will accept any alpha-numeric string
  88.       of up to seven characters. Enter the command:
  89.  
  90.                 SYDEMO SDEMO.EXE IXXX
  91.  
  92.       Note that the command line arguments are NOT case sensitive, and
  93.       may be issued in any sequence. A target file may be altered 
  94.       repeatedly, merely overwriting previous entries.
  95.  
  96.       View the embedded code with the command:
  97.  
  98.                 SYDEMO SDEMO.EXE
  99.  
  100.       Notice that the identification code is now reported as DEMO_01.
  101.       Just for fun, try to find and alter that code using DEBUG, NU,
  102.       or PCTools. Bet you can't - the code is encrypted before 
  103.       branding!
  104.  
  105.                                -3-
  106.  
  107.  
  108. 5. Demonstrate altering the internal default for the X parameter next. 
  109.       Determine the value of X (excluded memory) that will cause a
  110.       clipper-compiled program to fail to run, using different X 
  111.       values in a SET CLIPPER=Xxxx statement. Then insert that value 
  112.       into the test file with the command:
  113.  
  114.                 SYDEMO TESTFILE.EXE Xxxx
  115.  
  116.       Note that SEZ_YOU! reports X both before and after alteration.
  117.       Now, clear the previous environmental string and then attempt to 
  118.       run the test program:
  119.  
  120.                 SET CLIPPER=       (clear the environment)
  121.                 TESTFILE
  122.  
  123.       Notice that the program behaves exactly as it did with the 
  124.       environmental string. You can also verify that the environmental
  125.       string will over-ride the internal value by re-issuing the SET 
  126.       CLIPPER command and then executing the altered program 
  127.       successfully:
  128.  
  129.                 SET CLIPPER=x0  (eXclude no memory, will over-ride X) 
  130.                 TESTFILE
  131.  
  132. 6. Demonstration of the R-parameter is a little more tricky and 
  133.       depends upon your available memory and the size of the 
  134.       clipper-compiled and target programs involved. Experiment with 
  135.       different values for R in a SET CLIPPER string, and then repeat 
  136.       the trials using SEZ_YOU! to insert similar values into the 
  137.       clipper-compiled program. Again, you will find that the behavior 
  138.       mimics the environmental-string controlled behavior, and that 
  139.       the environmental string will over-ride the internal value. 
  140.  
  141.       In order to demonstrate this more easily, the demo program SDEMO 
  142.       has been set up to hog most of the available memory, and 
  143.       then to attempt to RUN SYDEMO.  This will succeed or fail 
  144.       based on the R value (either internal or environmental-string). 
  145.       SEZ_YOU! requires about 33K to run, and so, setting R to a lower 
  146.       number will cause a failed RUN, and a higher number will usually 
  147.       succeed (although memory fragmentation may make this somewhat 
  148.       unpredictable). Again, convince yourself that the internally 
  149.       altered value behaves similarly to a SET CLIPPER=Rxxx trial.
  150.  
  151.                 SET CLIPPER=R20     
  152.                 SDEMO            (will fail to RUN SYDEMO)
  153.  
  154.                 SET CLIPPER=R40     
  155.                 SDEMO            (will usually RUN SYDEMO)
  156.  
  157.                                -4-
  158.  
  159.  
  160.                 SET CLIPPER=     (be sure to clear the environment)
  161.                 SYDEMO SDEMO R20 
  162.                 SDEMO            (will also fail to RUN SYDEMO)
  163.  
  164.                 SYDEMO SDEMO R40
  165.                 SDEMO            (will also usually RUN SYDEMO)
  166.  
  167.                 SYDEMO SDEMO R20
  168.                 SET CLIPPER=R40
  169.                 SDEMO            (will run because SET CLIPPER=R40
  170.                                   over-rides the internal value)
  171.  
  172.       This also points out the need for the ability to change the name 
  173.       of the environmental string to which our clipper-compiled 
  174.       program will respond. Other applications may place a SET CLIPPER
  175.       string in the environment, and its values would, of course
  176.       over-ride the internally-set values if our program were looking 
  177.       for the string named "CLIPPER". By changing the name, our 
  178.       application is protected from such interference, but we can 
  179.       still alter its behavior either by re-running SEZ_YOU!, or by 
  180.       using a string of the correct name. This capability is not 
  181.       available in the trial-size SEZ_YOU!, but fully supported in the 
  182.       full version.  
  183.  
  184.  
  185. 7.  Companion functions are provided to allow the program to determine
  186.       it's own environmental variable settings and string name. These 
  187.       may be of use in an error-reporting routine, to help to capture 
  188.       the state of the machine. The trial-size package only reports 
  189.       the state of the R and X values, however. Additionally, a 
  190.       function is provided to return the decrypted identification 
  191.       code. Displaying this code prominently on screens and reports 
  192.       may help to discourage unauthorized copying of your application. 
  193.       These functions are quite small, and are written in assembly 
  194.       language.
  195.  
  196.                                -5-
  197.  
  198.  
  199.                          OBTAINING SEZ_YOU!
  200.  
  201.  
  202. The introductory price for SEZ_YOU! is $49.00, plus $5.00 for shipping 
  203. and handling; please call for express mail, 3-1/2" disk availability, 
  204. or any other information. It is backed with a 30-day guarantee of your 
  205. money-back if it doesn't perform as advertised.
  206.  
  207. SEZ_YOU! is being distributed by:
  208.  
  209.  
  210.                          PROGRAMMING SOLUTIONS
  211.                          5320 South 900 East, Suite 100
  212.                          Salt Lake City, Utah  84117
  213.                          (voice) 801/262-4141
  214.                          (Compuserve 73320,3117)
  215.  
  216.  
  217.  
  218. Support will be provided by mail, telephone, or Email on CompuServe.
  219.  
  220.  
  221.  
  222.  
  223.                           LEGAL STUFF
  224.  
  225. You are encouraged to copy this demonstration program freely. It may 
  226. be uploaded to other boards, although Email support may not be 
  227. available other than on CompuServe.
  228.  
  229. This demonstration package is not to be sold, nor is it placed in the 
  230. public domain. All of the related files must be included in the 
  231. archive, and no files may be altered:
  232.  
  233.                 README.1ST  - this file
  234.                 SYDEMO.EXE  - trial-size version of SEZ_YOU!
  235.                 SDEMO.OBJ   - Clipper-compiled demo program
  236.                 GETDEMO.OBJ - related functions for the demo program
  237.                 FLYER.TXT   - SEZ_YOU! promotional flyer
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247. SEZ_YOU! (c) Copyright 1989 SoundView Data Systems, All rights reserved
  248.                        Clipper (tm) Nantucket
  249.  
  250.  
  251.